home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / compress / xpack164.zip / XPACK.DOC < prev    next >
PGP Signed Message  |  1996-10-07  |  18KB  |  435 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3.  
  4.      XPACK    An Executable, Datafile... and DiskImage Compressor
  5.  
  6.      Copyright (c) 1995-1996 by JauMing Tseng
  7.  
  8.    WHAT IS XPACK?
  9.  
  10.      XPACK is an EXE/COM/SYS Executable file compressor. This program
  11.      compresses most DOS executable files. Compressed programs use
  12.      less disk space because they are much smaller,
  13.      yet they run EXACTLY as before.
  14.  
  15.      XPACK also allows a compressed diskette image to be created for
  16.      electronic transmission.  The compressed diskette image can be
  17.      transmitted with the use of a modem on regular phone line, or any
  18.      other electronic networks. It can be used to archive diskette
  19.      images on hard drives or tapes. This gaurantees the contents of
  20.      the diskette to be the same as the original -- including all
  21.      directory structures, date and time stamps of all the files and
  22.      directories. This is useful for archiving bootable diskettes, too.
  23.  
  24.      XPACK is also a powerful file compressor with RAM resident
  25.      transparent expander(XPACK OnLine DeCompression System), which
  26.      gives painless access to compressed files. This is done by
  27.      intercepting DOS calls, allowing applications to read compressed
  28.      files just as before. Just put a command(XPACK -z) to load
  29.      XPACK into the AUTOEXEC.BAT file and forget it.
  30.  
  31.      The RAM resident part of XPACK OnLine DeCompression System uses
  32.      3KB of Upper memory and 32KB of EMS memory.
  33.  
  34.    SYSTEM REQUIREMENTS.
  35.  
  36.      XPACK works on any IBM-compatible machine with 192Kb of free
  37.      DOS memory.
  38.  
  39.      method 4 need extra 192Kb,
  40.      method 5 need extra 147kb for compression
  41.  
  42.      Every file compressed with XPACK can run on any IBM compatible
  43.      system: XT, AT, 80286, 80386, 80486, Pentium or Pentium Pro;
  44.      on Intel and non-Intel.
  45.  
  46.    USING XPACK.
  47.  
  48.      Enter the command:   XPACK [options] filename
  49.  
  50.        where "filename" is the name of the Executable file to be compressed.
  51.        XPACK will only work properly on Executable files, so if you do not
  52.        type a file extension, ".EXE", ".COM" or ".SYS" is assumed.
  53.        The filename can include drive and path specifications
  54.        and wildcards (* or ?).
  55.        The various "options" are explained later.
  56.  
  57.      XPACK will make an Executable file that:
  58.        (a) is smaller than the original, and
  59.        (b) works as before, without any noticeable loss of speed.
  60.  
  61.      The computer may take several seconds to do the compressing. If
  62.      you are impatient you can interrupt the process by pressing the
  63.      ESC key.
  64.  
  65.      Not every .EXE file can be compressed with XPACK.
  66.      (e.g. .EXE with internal overlay packed with option /g)
  67.      That's why this program creates backups. The original FILENAME.EXE file
  68.      is renamed to FILENAME.OLE. If anything goes wrong you can
  69.      restore the original file by entering these 2 commands at
  70.      the DOS prompt:
  71.                       COPY FILENAME.OLE FILENAME.EXE
  72.                       DEL FILENAME.OLE
  73.      (.COM and .SYS files are always packed ok.)
  74.  
  75.    OPTIONS.
  76.  
  77.      Any "options" that you use are typed after "XPACK" and
  78.      before "FILENAME".
  79.  
  80.      Options are all case-insensitive, separated by spaces, and begin
  81.      with either the hyphen ('-') or the slash ('/') character.
  82.  
  83.      Here are the details of the command line options:
  84.  
  85.         -?  This switch invokes option -h
  86.  
  87.         -h  This switch tells XPACK to display a
  88.             Help Screen to the DOS console device.
  89.  
  90.                You can use "XPACK /? > XPACK.HLP" to save it.
  91.  
  92.         -4  This switch tells XPACK to use pack method 4
  93.             best ratio
  94.  
  95.         -5  This switch tells XPACK to use pack method 5 (default)
  96.             2nd compression ratio
  97.             fastest compression
  98.             quickest extraction
  99.             smallest sfx
  100.  
  101.         -x  expand a compressed .COM or .SYS file.
  102.  
  103.         -f  This switch tells XPACK to convert the file even if
  104.             the result is bigger than the original file. (Not many
  105.             users will take advantage of this option!)
  106.  
  107.         -o  This switch tells XPACK to override the default
  108.             generation of FILENAME.OLE backup files. (Use this only
  109.             if you have already determined that XPACK compresses
  110.             the file(s) successfully.)
  111.  
  112.         -g  This tells XPACK to merge an overlay into packed file.
  113.  
  114.              (See note below concerning files that cannot be packed.)
  115.  
  116.                Without the -g option, XPACK does not try to compress
  117.                an .EXE file that contains overlays.
  118.  
  119.              The -g option may not work with every .EXE that contains
  120.              an overlay. It works well with .EXE files compiled from
  121.              text (ASCII) with TURBOTXT (an excellent program that is
  122.              supplied with the registered version of the TURBOBAT
  123.              batch file compiler), overlay programs compiled by
  124.              TURBO/BORLAND Pascal and Clipper 5.2 with Blink 3.0
  125.  
  126.         -pd  Pack files as Data
  127.              those data files can be used by XPACK OnLine Decompression System
  128.              which gives painless access to XPACKed-Data files
  129.  
  130.         -ud  Unpack XPACKed-Data files
  131.  
  132.         -z   install (stay resident) Xpack OnLine DeCompression System
  133.  
  134.         -zr  release (uninstall TSR) Xpack OnLine DeCompression System
  135.  
  136.         -z-  deactive (turn TSR off) Xpack OnLine DeCompression System
  137.  
  138.         -z+  active   (turn TSR on ) Xpack OnLine DeCompression System
  139.  
  140.         -ux  Ultra eXpander for some high level language compiled progys! :D
  141.              (to unpack a overlay-exe, plz remember use fullpath&extension)
  142.              (this option doesn't accept wildcards! :D)
  143.  
  144.    USING XPACK to create compressed diskette image.
  145.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  146.      Enter the command:   XPACK option drive: filename
  147.  
  148.        where "filename" is the name of the compressed diskette image file.
  149.        If you do not type a file extension, ".XDI" is assumed.
  150.        The filename can include drive and path specifications.
  151.  
  152.      Here are the details of the new options:
  153.  
  154.         -p  Pack the diskette in drive: to filename
  155.  
  156.         -u  Unpack to the diskette in drive: from filename
  157.             the filename here can include wildcards (* or ?).
  158.  
  159.      EXAMPLES.
  160.      ~~~~~~~~~
  161.        To compress all the .EXE files in the current directory
  162.        just type:
  163.                           XPACK *.EXE
  164.  
  165.        To compress without backup all .EXE files in C:\PROGS,
  166.        type:
  167.                           XPACK /O C:\PROGS\*.EXE
  168.  
  169.        To pack all the Executable files using method 4, enter this
  170.        command:
  171.                           XPACK /4 *
  172.  
  173.        To compress BUMF.EXE (made from BUMF.TXT using TURBOTXT),
  174.        enter the command:
  175.                           XPACK -g BUMF
  176.  
  177.        To create a compressed diskette image named MYDISK.XDI from drive B:
  178.        type:
  179.                           XPACK -p b: MYDISK.XDI
  180.  
  181.        To unpack (restore) a compressed diskette image C:\BOOT.XDI to drive A:
  182.        type:
  183.                           XPACK -u a: C:\BOOT
  184.  
  185.        To pack all the files as data in D:\MYDATA
  186.        type:
  187.                           XPACK -Pd d:\mydata\*
  188.  
  189.        To unpack all the XPACKed-Data files in E:\MYfile
  190.        type:
  191.                           XPACK -Ud e:\myfile\*.*
  192.  
  193.        To install (stay resident) Xpack OnLine DeCompression System
  194.        type:
  195.                           XPACK -z
  196.  
  197.        To release Xpack OnLine DeCompression System
  198.        type:
  199.                           XPACK -zr
  200.  
  201.        To deactive Xpack OnLine DeCompression System
  202.        type:
  203.                           XPACK -z-
  204.  
  205.        To active Xpack OnLine DeCompression System
  206.        type:
  207.                           XPACK -z+
  208.  
  209.      FILES THAT CAN'T BE PACKED.
  210.  
  211.        Some files can't be compressed with XPACK.
  212.  
  213.                - Programs that check the CRC of a file
  214.                - Files that store configuration data internally
  215.                - Drivers that can be loaded in a
  216.                    config.sys file (EMM386.EXE)
  217.                - Some files with "overlays" or DOS4GW overlays, etc..
  218.                    Some "overlaid" files can't be compressed because
  219.                    when you compress such a file the overlay offset
  220.                    changes and the compressed program may not find
  221.                    an overlay.
  222.  
  223.      WINDOWS AND OS/2 FILES.
  224.  
  225.        XPACK currently cannot Pack Windows or OS/2 New .EXEs are
  226.        because at the ends of these files there are resources,
  227.        which have to be located there. (e.g. the BITMAPs, Dialogue, Boxes,
  228.        Buttons, and Icons)
  229.  
  230.          These resources are loaded not with the execution
  231.        of the file, but only when needed by Windows or OS/2.
  232.  
  233.          Windows and OS/2 files are automatically recognized by
  234.        XPACK.
  235.  
  236.        i'm trying to add functions to compress:
  237.        Windows 3.1, Windows 95, OS/2, DOS protect mode, DOS overlay
  238.        executables in near future! (plz .. wait:D)
  239.  
  240.      DISTRIBUTING XPACK.
  241.  
  242.        The XPACK utility is protected by copyright, and may be
  243.        distributed only according to the following limitations:
  244.          1) NO price may be charged, other than a fee for copying
  245.             and mailing the disk.
  246.          2) The utility and documentation must be included together,
  247.             in unmodified form. The XPACK.COM, XPACK.DOC and XPACK.BG5
  248.             files must stay together.
  249.  
  250.        XPACK can be freely uploaded to any BBS, online system or
  251.        something similar, and can be freely included on any CD-ROM.
  252.  
  253.        You can only distribute compressed executables or DiskImages
  254.        if you register XPACK.
  255.  
  256.      Verify Authentication
  257.      ~~~~~~~~~~~~~~~~~~~~~
  258.        To verify authentication, you can use pgp to check the signatures,
  259.        the correct messages should read:
  260.  
  261.        ...
  262.        Good signature from user "JauMing Tseng <s8203143@simon.pu.edu.tw>".
  263.        Signature made 1996/??/?? ..... GMT using 2048-bit key, key ID EE317325
  264.        ...
  265.  
  266.        To get author's public key, send a email to s8203143@simon.pu.edu.tw
  267.        with Subject: get public key
  268.        tnx:)
  269.                                                                                 
  270.      CREDITS & Greetings
  271.  
  272.         Optimized by http://www.xs4all.nl/~feldmann
  273.         Revised documentation (XPACK.DOC) by John Kiernan.
  274.         I thank the following people for testing and suggestions:
  275.         Fred Lu, John Kiernan, ChengChang Liu,
  276.         Harald Feldmann(Author Hamarsoft HAP archiver), Jeff Gilchrist,
  277.         Henrik Haftmann, Michal Weis, Peter Hubinsky (Slovak Antivirus Center),
  278.         Cristi Bradiceanu (The DOP), Tomas Hajny, Roeland Louwe Kooijmans,
  279.         Keith Petersen (General Manager of Simtel), Peter Gutmann, Frank Zago,
  280.         Adam Nikic, Timo Salmi, Mika Koykka, Henry Juhani Aro, Ron van Daal,
  281.         Roberto Favaretti, Bulent Eren, Michael E. Webb, Stefan Raaijmakers,
  282.         uNDeRWoRLD^TPiNC/CNF, Veit Kannegieser(Author DiskEMU),
  283.         Marcel Blanchet, Synopsis. Thank you!
  284.  
  285.         HOW DOES XPACK WORK?
  286.  
  287.           The XPACK utility works by compressing an
  288.           executable file.  The encoded program is written back to
  289.           disk under the original file name, with a relocating
  290.           decoder attached to the file.
  291.  
  292.             When the executable file executes, control passes to the
  293.           relocating decoder, which relocates itself (and the
  294.           encoded data) higher in memory. It then decodes the
  295.           program into the same place it would have been loaded if
  296.           it were not encoded. The XPACKed program resets the registers
  297.           and flags to their original forms and starts the program
  298.           just as if there had never been any encoding.
  299.  
  300.             If a "CRC" check failure occurs during decoding .EXE, it will
  301.           display a message:
  302.  
  303.             "This program has been damaged and cannot be run!"
  304.  
  305.           and return the user to DOS.
  306.  
  307.             XPACK has a security function that prevents the .EXE program
  308.           from running if it has been tampered with or accidentally
  309.           corrupted.  You can be pretty certain that your program will
  310.           come up with all the proper screens without hanging
  311.           due to unwanted modification. Your program's underlying
  312.           data will not be left in the open (to any one with a hex editor
  313.           or disassembler) and your code will be safer from others' eyes.
  314.  
  315.         HOW DOES XPACK OnLine DeCompression System WORK?
  316.  
  317.         Once loaded, XPACK OnLine DeCompression System gives automatic
  318.         access on demand to compressed data files. It does this by
  319.         intercepting any calls a program (including COMMAND.COM) makes to DOS.
  320.         Normally, XPACK OnLine DeCompression System passes these calls
  321.         straight on to DOS, but when a call is detected which opens a
  322.         compressed data file, XPACK OnLine DeCompression System reads the
  323.         data file and makes a full size copy on disk for the program to use.
  324.         It then changes the name of the compressed data file to a name it
  325.         recognizes itself and renames the new full size file to the original
  326.         file name. Only then does it pass the call on to DOS. Neither DOS nor
  327.         the program know that this is happening, so operation is completely
  328.         automatic. When an expanded data file is closed without being modified,
  329.         XPACK OnLine DeCompression System deletes the expanded copy and renames
  330.         the original compressed data file to its original name. If a program
  331.         modifies an expanded copy of a data file, XPACK OnLine DeCompression
  332.         System deletes the compressed original and leaves the expanded new
  333.         data file on disk.
  334.  
  335.         A Special Case to XPACK OnLine DeCompression System? :D
  336.  
  337.         XPACK OnLine DeCompression System gives programs the illusion that
  338.         small data files are big data files. It does this very successfully
  339.         and almost all of the software is fooled all of the time.
  340.  
  341.         A special case is where a program obtains the size of a file from
  342.         its directory entry and then reads that number of bytes when it
  343.         opens the file. The intention is to read the whole file.
  344.  
  345.         This behavior has been seen with the DOS XCOPY command ( DOS Ver
  346.         6.22 at least) and PKZIP (Ver 1.01, 2.04g at least ) from PKWARE.
  347.  
  348.         XPACK OnLine DeCompression System still works well with those
  349.         applications! :D
  350.  
  351.      HELP and SUGGESTED IMPROVEMENTS.
  352.  
  353.          Send them to the author:
  354.  
  355.           Intelnet e-mail: s8203143@simon.pu.edu.tw
  356.  
  357.      URL:
  358.           http://140.128.9.3/home1/86Ga/s8203143/public_html/xpack.html
  359.           (Dep. of Computer Science and Info. Mgt, Providence Univ.)
  360.  
  361.        The latest version of XPACK can always be found on:
  362.  
  363.            Slovak Antivirus Center: ftp.elf.stuba.sk /pub/pc/pack
  364.            Walnut Creek CDROM: ftp.simtel.net /pub/simtelnet/msdos/execomp
  365.            Garbo archives: garbo.uwasa.fi /pc/execomp
  366.  
  367.            Some mirrors of Slovak Antivirus Center:
  368.  
  369.            ftp.vse.cz           /pub/msdos/SAC/pc/pack            (Czech)
  370.            ftp-beer.bke.hu      /vol1/pub/sac/pc/pack             (Hungary)
  371.            ftp.cs.tu-berlin.de  /pub/msdos/mirrors/stuba/pc/pack  (Germany)
  372.  
  373.      DISCLAIMER.
  374.  
  375.        Under no circumstances can I be held responsible for any damage
  376.        caused by files in this or any other package containing programs
  377.        written by me.
  378.  
  379.      All programs mentioned in this documentation are trademarks of their
  380.      respective owners. They are used for identification purposes only.
  381.  
  382.      Registration
  383.      ~~~~~~~~~~~~
  384.         XPACK(1.60+) is NOT a free program. It is being released
  385.         as shareware. This means that you are allowed to try out
  386.         XPACK and its various features for a limited  amount  of
  387.         time,  in which you may evaluate the suitability of this
  388.         software to your use.
  389.  
  390.         XPACK  has  not  been  disabled  in  any  way   in   the
  391.         shareware version. One is granted a  30  day  period  in
  392.         which  to  evaluate  the  suitability  of XPACK to one's
  393.         needs.  If you use  XPACK  for a period longer than this
  394.         evaluation period, it is assumed that XPACK is of use to
  395.         you, and that you will register it.
  396.  
  397.         European users please see xpack.frm for details :)
  398.  
  399.         Other foreign users please read the following:
  400.         ---
  401.         The Registered Version of this program(v161) can be purchased and
  402.         received immediately on the Internet at Albert's Ambry.
  403.         Registration at Albert's also eliminates shipping and handling costs.
  404.         Please go to:
  405.                         http://www.alberts.com
  406.  
  407.         Search on: >> xpack161.zip <<
  408.  
  409.         Click on the "Buy It" Hotlink to register this software.
  410.  
  411.         Thank you for registering this program. :)
  412.         ----
  413.         Registered users will receive more Bonus Pack: Utilities
  414.         or Sources and get a lifetime free upgrades.
  415.  
  416.         Have you decided to register?  That's very kind of  you.
  417.         Thanks!   The  more   registrations  i  get   the   more
  418.         improvements i will make to this program.
  419.  
  420.   End of the XPACK documentation file.
  421.  
  422.  
  423. -----BEGIN PGP SIGNATURE-----
  424. Version: 2.6.3i
  425. Charset: cp850
  426.  
  427. iQEVAwUBMlnOd2A4W6nuMXMlAQEeZwf/fgOThZSp1sJ0SwFDlY9EV2kPlAJTziWY
  428. adh3ZGOh6CS4/fACfCuD7ZY8WQmfgabCgVYFys+9iKtkQgiIc1bGaun79Xz1ZWD8
  429. 7oSPjxjc9KaBtG0G5k/1jNWE/T0izei6zqUMH/GfeN1tyAabWuIYB4QhSuWS9Lf8
  430. ehnxkC+dDAgCmwLwgfnLqYzEzEPMMqfHT+FpbxKDsgYWcouXyFDdv7N+z68yAZD4
  431. o6pnPDHbPLZoVlIt7DOJDykAmpuzCIGpcD3JbC1++TXiyhn6Xbesvz1MvDyy//f6
  432. ZHAapwmh/L672xLCqmeFQEpJ+id36YTaQL3wko3VznhEl/i+uTM2og==
  433. =SOOl
  434. -----END PGP SIGNATURE-----
  435.